home *** CD-ROM | disk | FTP | other *** search
/ Landsat 5 - Satellite Image Gallery 1.5 / Landsat 5 - Satellite Image Gallery 1.5.iso / lsf / lsf.doc < prev    next >
Text File  |  1995-04-07  |  20KB  |  531 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                 
  8.  
  9.                      LANDSAT SCENE FINDER 2.0
  10.                               (LSF)
  11.                           USER'S GUIDE
  12.  
  13.  
  14.  
  15.  
  16.                           Prepared For
  17.  
  18.                EARTH OBSERVATION SATELLITE COMPANY
  19.                    Goddard Space Flight Center
  20.                        Greenbelt, Maryland
  21.  
  22.  
  23.                                By
  24.  
  25.                   COMPUTER SCIENCES CORPORATION
  26.                               (CSC)
  27.  
  28.                               Under
  29.  
  30.                         Contract  A10001
  31.  
  32.  
  33.                          Modified Under
  34.                        PO# E01220 12/20/88
  35.  
  36.  
  37.                            March 1989
  38.    
  39.  
  40.  
  41.  
  42.  
  43. Prepared By:                      Approved By:
  44.  
  45. _______________________________   _______________________________
  46. H. Henry                   Date   T. Butschky                Date
  47. Software Developement             Software Manager
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.    
  57.    
  58.                           SECTION 1 - INTRODUCTION
  59.    
  60.    The Landsat Scene Finder (LSF) was developed to aid users of
  61.    Landsat data to find scenes that match a given set of criteria.
  62.    LSF allows the user to enter a point of interest either in
  63.    latitude/longitude or path/row coordinates, output graphically
  64.    for both the day and night scene, and the adjacent scenes for
  65.    that point of interest.  Information can be displayed on the
  66.    screen in either text or graphic format.
  67.    
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.    
  82.                 SECTION 2 - HARDWARE AND SOFTWARE REQUIREMENTS
  83.    
  84.    In order to use the LSF application, the following hardware and
  85.    software is required.
  86.    
  87.              Required Equipment
  88.    
  89.           o       IBM PC (or a compatible) with a minimum of 640K of
  90.                   memory and at least 1/2 Megabyte of available hard
  91.                   disk storage
  92.    
  93.           o       EGA Compatible Color Monitor capable of 640 x 350
  94.                   resolution
  95.    
  96.           o       EGA Compatible Color Graphics Adapter capable of
  97.                   640 x 350 resolution
  98.    
  99.           o       Math Coprocessor
  100.    
  101.              Required Software 
  102.    
  103.           o       PC-DOS 3.0 or higher operating system.
  104.    
  105.              Options
  106.    
  107.           o       Raster Type Hard Copy Device (equivalent to a
  108.                   CALCOMP COLORMASTER)
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.    
  117.    
  118.  
  119.                       SECTION 3 - OPERATIONAL PROCEDURES
  120.    
  121.    The procedures contained herein assume that the LSF is properly
  122.    installed on the users hard disk.
  123.    
  124.    3.1       STARTING UP THE LANDSAT SCENE FINDER
  125.  
  126.    To start go to the directory where the LSF files are located.  To
  127.    do this type "CD\LSF" and press [ENTER].  To load the system type
  128.    "LSF" and press [ENTER].  The program will then display the menu
  129.    screen (see Figure 3-1).
  130.    
  131.    3.2       RUNNING THE LANDSAT SCENE FINDER
  132.    
  133.    LSF will begin with a highlighted box in the latitude field.  The
  134.    input fields available are Latitude, Longitude, Path, Row, and
  135.    Ground Correction fields (see Figure 3-2).  To change input
  136.    fields, enter a valid value and press the [ENTER] key; use the
  137.    arrow keys, or [TAB] key to position the highlighted box to the
  138.    desired input field.  If an error is detected in the input
  139.    values, LSF will sound an alarm and highlight the erroneous input
  140.    value to permit editing of this field. The numeric values can be
  141.    displayed by selecting the F8 function (see Section 3.15).  The
  142.    graphic representation can be displayed by selecting the F9
  143.    function (refer Section 3.16).
  144.    
  145.       NOTE:    The LSF will use the LAST PAIR of input values;
  146.              therefore, if a valid pair of Latitude/Longitude
  147.              points are input followed by the input of a valid pair
  148.              of Path/Row points, LSF will use the Path/Row points
  149.                 NOT  the Latitude/Longitude pair.
  150.    
  151.    3.2.1  EDITING INPUT FIELDS
  152.    
  153.    If after entering a value in an input field the user desires to
  154.    alter a value, LSF will allow editing the field.  The arrow keys
  155.    are used to move around in the field.  The [INSERT] key will
  156.    allow input at the cursor location in the field; the [DELETE] key
  157.    will allow deleting of characters at the cursor location in the
  158.    field.  The [HOME] key will position the cursor to the beginning
  159.    of the field, and the [END] key will position the cursor to the
  160.    end of the field.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.    
  170.    3.3       ENTERING LATITUDE/LONGITUDE COORDINATES
  171.    
  172.    To enter Latitude/Longitude coordinates, position the highlighted
  173.    box to the Latitude position on the screen.  Enter the desired
  174.    Latitude followed by pressing the [ENTER] key.  If LSF detects an
  175.    error, it will sound an alarm and allow the user to reenter or edit
  176.    the field (refer to Section 3.1.1).  To enter Longitude move the
  177.    highlighted box to the Longitude position on the screen and input the
  178.    desired Longitude followed by pressing the [ENTER] key.  If LSF
  179.    detects an error, it will sound an alarm and allow editing or
  180.    reentering of the field (refer to Section 3.2.1).
  181.    
  182.       NOTE:    If an incorrect value is entered twice in a row, LSF
  183.              will position the highlighted box to the next input
  184.              field.  When trying to either Recalc (F8) or Toggle to
  185.              graphics display (F9), LSF will detect the error, sound
  186.              an alarm, and position the highlighted box to the
  187.              erroneous field.
  188.    
  189.    3.4       ENTERING PATH/ROW COORDINATES
  190.    
  191.    To enter Path/Row coordinates, position the highlighted box to
  192.    the Path position on the screen; enter the desired path (valid
  193.    paths are 1-223) followed by pressing the [ENTER] key.  If LSF
  194.    detects an error, an alarm will sound and allow the user to
  195.    reenter or edit the field (refer to Section 3.2.1).  To enter row
  196.    coordinates position the highlighted box to the Row position on
  197.    the screen; enter the desired row (valid rows are 1-245) followed
  198.    by pressing the [ENTER] key.  Again, if LSF detects an error, it
  199.    will sound an alarm and allow the user to reenter or edit the
  200.    field (refer to Section 3.2.1).
  201.    
  202.       NOTE:      If an incorrect value is entered twice in a row, LSF
  203.                will position to the next input field.  When either
  204.                the Recalc (F8) or the Toggle to graphics display
  205.                (F9) key is depressed, LSF will detect the error,
  206.                sound an alarm,  and position the highlighted box to
  207.                the field where the error occurred.
  208.    
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.    3.5       ENTERING GROUND CORRECTION
  216.    
  217.    To enter ground correction, position the highlighted box to the
  218.    ground correction position on the screen.  Enter the desired ground
  219.    correction factor in kilometers.  If LSF detects an error it will
  220.    sound an alarm and allow either editing or reentering of the
  221.    field (refer to Section 3.2.1).
  222.    
  223.       WARNING:   The ground correction input affects the way LSF
  224.                calculates scene positions, therefore, entering
  225.                any value other than 0.0 has an impact.  LSF will
  226.                allow ground correction up to 20.00 kilometers;
  227.                however, the Landsat mission requirement for
  228.                spacecraft drift is +10.0 or -10.0 kilometers.
  229.    
  230.       NOTE:        If an incorrect value is entered twice in a row,
  231.                LSF will position to the next input field.  When trying
  232.                to either Recalc (F8) or Toggle to graphics display
  233.                (F9), LSF will catch the error, sound an alarm, and
  234.                position the highlighted box to the field where the
  235.                error occurred.
  236.    
  237.    3.6     TEXT DISPLAY PAGE
  238.    
  239.    The text display page can be broken up into two parts:  (1) the
  240.    user input data area (see Figure 3-2), and (2) the LSF output
  241.    area (see Figure 3-4).  The user display area consists of items
  242.    that may be inputted to LSF.  These items are as follows:
  243.    Path/Row or Latitude/Longitude, and Ground Correction.  The LSF
  244.    output area (see Figure 3-3) can be split up into two parts.
  245.    These parts are descending (DAY) or ascending (NIGHT) areas.
  246.    After successfully entering the desired point (refer to Sections
  247.    3.2 or 3.3 and 3.4), LSF will calculate and fill in the Path/Row
  248.    and the upper left corner, upper right corner, lower left corner,
  249.    lower right corner, center of the scene and center points 
  250.    between each corner in latitude, and longitude degrees for 
  251.    both day and night scenes.  If possible, it will also show the 
  252.    Quad number the point resides in for both Day and Night 
  253.    scenes. 
  254.    
  255.  
  256.  
  257.  
  258.  
  259.  
  260.    3.7       GRAPHICS DISPLAY PAGE
  261.    
  262.    When viewing the graphics screen, the numbers on the left are
  263.    latitude marks and the numbers on the bottom of the screen are
  264.    longitude marks.  At the top of the screen just below the text 
  265.    "LANDSAT SCENE FINDER" the point of interest is displayed in
  266.    degrees as is all Latitude and Longitude information on the 
  267.    graphics screen. At the bottom of the graphics screen to the 
  268.    left of the text Longitude if the NIGHT option is set to yes 
  269.    the night path/row information will be displayed in blue text. 
  270.    And to the right of the text Longitude if the DAY option is 
  271.    set to yes the day path/row information will be displayed in 
  272.    red. Day scenes are defined as "squares" which angle to the 
  273.    right and night scenes are defined as "squares" which angle to 
  274.    the left.  The symbol "X" represents scene centers and also 
  275.    the point of interest.  Lines going through the center of the 
  276.    "squares" indicate the spacecraft track.  These lines also 
  277.    have "arrows" showing which direction the spacecraft travels. 
  278.    LSF on the development system shows the Day scene as green 
  279.    "squares", Adjacent day scenes (green).  The point of interest 
  280.    is defined with a black "X" mark.  Each of the scene's center 
  281.    points are marked with the scenes surrounding color also using 
  282.    an "X" to mark the scene's center point.  It should be noted 
  283.    that different monitors and graphic cards MAY display 
  284.    different colors than the development system. 
  285.    
  286.  
  287.    3.8       HELP FUNCTION (F1)
  288.    
  289.    The Help function is only available when viewing the text screen
  290.    (see Figure 3-1).  To obtain help on any of the LSF functions,
  291.    depress the [F1] key while viewing the text screen.  A help
  292.    text window will appear on the middle of the text display.  To
  293.    obtain help on a function of LSF, depress the function key help is
  294.    desired on.  LSF will display the help window with the information
  295.    for the requested function.
  296.    
  297.  
  298.    3.9       DAY SCENE FUNCTION (F2)
  299.    
  300.    The Day Scene function provides the ability to select whether or
  301.    not Day Scenes are to be drawn on the graphics display.  The
  302.    current state of this function is displayed on the bottom of the
  303.    text screen in the status area of the display options (see Figure
  304.    3-4).  ON = Day scenes are displayed; OFF = Day scenes are not
  305.    displayed.
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.    3.10      NIGHT SCENE FUNCTION (F3)
  314.    
  315.    The Night Scene function provides the ability to select whether
  316.    or not Night Scenes are to be drawn on the graphics display. The
  317.    current state of this function is displayed on the bottom of the
  318.    text screen in the status area (see Figure 3-4).  ON = Night
  319.    scenes are displayed; OFF = Night scenes are not displayed.
  320.    
  321.  
  322.    3.11      ADJACENT SCENE FUNCTION (F4)
  323.    
  324.    The Adjacent Scene function provides the ability to select
  325.    whether or not Adjacent Scenes (the scenes which fall to the
  326.    left and right of the scene of interest) are to be drawn on the
  327.    graphics screen.  The current state of this function is displayed
  328.    on the bottom of the text screen in the status area (see Figure
  329.    3-4) as ON = Adjacent scenes will be drawn; or OFF = Adjacent
  330.    scenes will not be drawn.
  331.    
  332.  
  333.    3.12      QUAD FUNCTION (F5)
  334.    
  335.    The Quad function provides the ability to select whether or not
  336.    Quad Boundaries within the scene of interst are to be displayed
  337.    on the graphics page.  The current state of this function is
  338.    displayed on the bottom of the text screen in the status area
  339.    (see Figure 3-4) as ON = Quad boundaries will be drawn; or OFF =
  340.    Quad boundaries will not be drawn.
  341.  
  342.  
  343.    3.13      GRID FUNCTION (F6)
  344.    
  345.    The Grid function provides the ability to select whether or not a
  346.    Grid is displayed on the graphics page.  The Grid is drawn using
  347.    the latitude tick marks and projecting them horizontally and
  348.    using the longitude tick marks and projecting them vertically.
  349.    This provides the ability to exactly locate points on the
  350.    scene(s) view.  The current state of this function is displayed
  351.    on the bottom of the text screen in the status area (see Figure
  352.    3-4) as ON = Grid to be drawn; or OFF = Grid will not be drawn.
  353.    
  354.  
  355.    3.14      PRINT FUNCTION (F7)
  356.    
  357.    The Print function provides the ability to make a hardcopy of the
  358.    text screen.  This report is a reformatted text page display
  359.    showing the point of interest for both day and night scenes; the
  360.    scene center, upper left, upper right, lower left, lower right
  361.    corners, and the midpoints between each of the corners.
  362.    
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.    3.14.1    MAKING COLOR HARDCOPIES
  372.    
  373.    To make a color plot the user must have the screen dumping
  374.    utility installed (refer to hardware/software requirements in
  375.    Section 2) and depress both the [SHIFT] and [PRINT SCREEN] keys
  376.    together.
  377.  
  378.    
  379.    3.15      RECALC FUNCTION (F8)
  380.    
  381.    The Recalc function instructs LSF to (re)calculate scene
  382.    coordinates using the last selected point of interest.  Values for
  383.    the scene center, upper left, upper right, lower left, and lower
  384.    right corners, as well as midpoints between each corner are
  385.    computed and displayed for both Day and Night scenes
  386.    (see Figure 3-3).
  387.    
  388.  
  389.    3.16      TOGGLE TO GRAPHICS FUNCTION (F9)
  390.    
  391.    The toggle to graphics function instructs LSF to graphically
  392.    display the requested scene information based upon which
  393.    functions that have been selected by the user (refer to functions
  394.    F2, F3, F4, F5, F6, and see Figure 3-4).
  395.    
  396.  
  397.    3.17      EXITING LSF (F10)
  398.    
  399.    To exit LSF the user must depress the [F10] key while on the text
  400.    page.
  401.    
  402.    3.18      UP/LOW (Shift_F1)
  403.  
  404.    The show upper and lower scenes function will on the graphics screen
  405.    show the scenes above and below the requested area. The requested area
  406.    is defined by the user using the aforementioned functions. For example;
  407.    if the NIGHT function is set to No and both the ADJACENT scene function
  408.    and the Day scene funtion is set to Yes, when viewing the graphics
  409.    screen, the scene above and below the selected scene will be displayed
  410.    and the scene above and below each adjacent scene will be displayed.
  411.  
  412.    
  413.    
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421. ╔═════════════════════════════════════════════════════════════════════════════╗
  422. ║                           LANDSAT SCENE FINDER          Version 2.0         ║
  423. ╠═════════════════════════════════════════════════════════════════════════════╣
  424. ║ Select Point of Interest:    Latitude:              Longitude:              ║
  425. ║          or                                                                 ║
  426. ║ Select Scene of Interest:    Path:      Row:                                ║
  427. ║                                                                             ║
  428. ║ If you want to correct for actual orbit, as opposed to theoretical orbit,   ║
  429. ║ enter horizontal correction in kilometers:                                  ║
  430. ╠═════════════════╤════════════════════════╤═════════════════╤════════════════╣
  431. ║Descending (Day) │           Left         │     Center      │      Right     ║
  432. ║   Path: ppp     │   Top: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  433. ║   Row:  rrr     │Center: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  434. ║   Quad: N/A     │Bottom: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  435. ╠═════════════════╪═══════════════════════════════════════════════════════════╣
  436. ║Ascending (Night)│           Left         │     Center      │      Right     ║
  437. ║   Path: ppp     │   Top: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  438. ║   Row:  rrr     │Center: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  439. ║   Quad: N/A     │Bottom: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  440. ╠═════════════════╧═══════════════════════════════════════════════════════════╣
  441. ║ F1-Help    F8-Recalc   F9-Toggle to Graphic Display   F10-Exit              ║
  442. ║            F7-Print Report                                                  ║
  443. ║ Display Options:  F2-Day (Yes )   F3-Night (No)   F4-Adjacent Scenes (No )  ║
  444. ║                   F5-Quad (Yes )  F6-Grid (No)    Shift_F1-Up/Low (Yes)     ║
  445. ╚═════════════════════════════════════════════════════════════════════════════╝
  446.  
  447.                                Figure 3-1
  448.                             (LSF Menu page)
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456. ╔═════════════════════════════════════════════════════════════════════════════╗
  457. ║                           LANDSAT SCENE FINDER          Version 2.0         ║
  458. ╠═════════════════════════════════════════════════════════════════════════════╣
  459. ║ Select Point of Interest:    Latitude:              Longitude:              ║
  460. ║          or                                                                 ║
  461. ║ Select Scene of Interest:    Path:      Row:                                ║
  462. ║                                                                             ║
  463. ║ If you want to correct for actual orbit, as opposed to theoretical orbit,   ║
  464. ║ enter horizontal correction in kilometers:                                  ║
  465. ╠═════════════════╤════════════════════════╤═════════════════╤════════════════╣
  466.  
  467.                                Figure 3-2
  468.                             (LSF Input Area)
  469.  
  470.  
  471.  
  472. ________________________________________________________________________________
  473.  
  474.  
  475.  
  476. ║Descending (Day) │           Left         │     Center      │      Right     ║
  477. ║   Path: ppp     │   Top: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  478. ║   Row:  rrr     │Center: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  479. ║   Quad: N/A     │Bottom: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  480. ╠═════════════════╪═══════════════════════════════════════════════════════════╣
  481. ║Ascending (Night)│           Left         │     Center      │      Right     ║
  482. ║   Path: ppp     │   Top: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  483. ║   Row:  rrr     │Center: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  484. ║   Quad: N/A     │Bottom: lat.dd, long.dd │ lat.dd, long.dd │ lat.dd, long.dd║
  485. ╠═════════════════╧═══════════════════════════════════════════════════════════╣
  486.  
  487.                                 Figure 3-3
  488.                             (LSF Output Area)
  489.  
  490.  
  491.  
  492.  
  493. ╠═════════════════╧═══════════════════════════════════════════════════════════╣
  494. ║ F1-Help    F8-Recalc   F9-Toggle to Graphic Display   F10-Exit              ║
  495. ║            F7-Print Report                                                  ║
  496. ║ Display Options:  F2-Day (Yes )   F3-Night (No)   F4-Adjacent Scenes (No )  ║
  497. ║                   F5-Quad (Yes )  F6-Grid (No)    Shift_F1-Up/Low (Yes)     ║
  498. ╚═════════════════════════════════════════════════════════════════════════════╝
  499.  
  500.                              Figure 3-4
  501.                           (LSF Status Area)
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.    
  510.                                  ACRONYMS
  511.    
  512.    CSC            Computer Sciences Corporation
  513.    
  514.    EGA            Enhanced Graphics Adapter
  515.    
  516.    EOSAT          Earth Observation Satellite Comp[any
  517.    
  518.    IBM            International Business Machines Corporation
  519.    
  520.    LSF            Landsat Scene Finder
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.